Last Update: 2025/3/26

SenseFlow Upload API

The SenseFlow Upload API allows you Upload files to Agent.

Endpoints

Upload File

POST https://platform.llmprovider.ai/v1/agent/files/upload

Upload files (currently only supports images) for use in multimodal interactions. Supports png, jpg, jpeg, webp, and gif formats.

Request Headers

Header	Value
Authorization	Bearer YOUR_API_KEY
Content-Type	multipart/form-data

Request Body Parameters

Parameter	Type	Description
model	string	agent name
file	file	The file to upload. file maxsize <= 20M
user	string	User identifier (must match the message API user ID)

Response

Field	Type	Description
id	uuid	File ID
name	string	File name
size	integer	File size in bytes
extension	string	File extension
mime_type	string	File MIME type
created_by	uuid	Uploader ID
created_at	timestamp	Upload timestamp

Example Response

{
  "id": "72fa9618-8f89-4a37-9b33-7e1178a24a67",
  "name": "example.png",
  "size": 1024,
  "extension": "png",
  "mime_type": "image/png",
  "created_by": 123,
  "created_at": 1577836800
}

Example Request

Shell

curl -X POST 'https://platform.llmprovider.ai/v1/agent/files/upload' \
--header 'Authorization: Bearer {api_key}' \
--form 'file=@localfile;type=image/[png|jpeg|jpg|webp|gif] \
--form 'model='
--form 'user=abc-123'

Python

import requests
import json

api_key = 'YOUR_API_KEY'
url = 'https://platform.llmprovider.ai/v1/agent/files/upload'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

files = {
    'model': '',
    'file': ('image.jpg', open('localfile', 'rb'), 'image/jpeg'),
    'user': (None, 'abc-123')
}

response = requests.post(url, headers=headers, files=files)
print(response.json())

Node.js

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const url = 'https://platform.llmprovider.ai/v1/agent/files/upload';

const form = new FormData();
form.append('model', '');
form.append('file', fs.createReadStream('localfile'));
form.append('user', 'abc-123');

const headers = {
    ...form.getHeaders(),
    'Authorization': `Bearer ${apiKey}`
};

axios.post(url, form, {headers})
    .then(response => console.log(response.data))
    .catch(error => console.error(error));